例セグメント・フィード

セグメントとはマーチャントが定義する有意な属性、例えば年齢、性別、行動、購入金額などによるユーザーのグループです。リッチレリバンスのEngageを使用し、セグメントを直接作成し操作することができますが、すでにセグメント・ライブラリをお持ちであればセグメント・フィードを使用してそれらを読み込むことができます。この方法で読み込んだセグメントをリッチレリバンスのRecommendでも使用できます。

このページは、セグメントとセグメント関連情報をEngageに提供するセグメント・フィードの準備をする担当者の方を対象としています。

セグメント・フィードの読み込みは自動処理なので、手動で各セグメントを追加するより簡単です。

フィードを使う際は、すべての必須ファイルを用意しすべての必須情報が含まれていることを確認してください。

弊社に送られたフィード・ファイルの情報はデータベースに挿入され、Engageによるコンテンツのレコメンデーションに活かされます。

セグメント

クライアントが作成したセグメントをEngageに取り入れる方法は2つあります。

1つ目は、ダッシュボードで直接作成しJavaScriptタグでトリガーする方法です。
2つ目はフィードで送る方法です。この場合セグメント・データは付随するユーザーIDと合わせてUPSに保存されます。

この2つは全く異なる方法であり、どちらかを選択する前に、それぞれ考察すべきことがあります。詳細について以下で説明します。

ダッシュボードでセグメントを作成しタグでトリガーする方法

ダッシュボードでセグメントを作成した場合、粉のセグメントはユーザーIDと直接的紐付いていません。そのためJavaScriptタグで提供されない限りどのユーザーがこのセグメントに属するかが分かりません。したがって追加の作業が必要となります。セグメントをタグに含めすべて繋がった状態とする必要があります。この作業にはR3_COMMON.addSegment()タグを使用します。以下が構文です。

R3_COMMON.addSegment('SEGMENT ID', 'SEGMENT NAME');

これをすべてのページのインスツルメンテーションに追加しユーザーIDとセグメントが正しく紐づくようにしてください。

セグメントをフィードで送る方法

セグメント・フィードは毎日アップロードする必要はありません。セグメント・データに更新や変更があった場合のみアップロードしてください。通常は週ごと、月ごと、あるいはその他の間隔で定期的にアップロードします。APIやJavaScriptタグによって個別に実行することもできます。

パイプ区切りを使用したcsv形式のテキスト・ファイルであるカタログ・フィードやコンテンツ・フィードとは異なり、セグメント・フィードはJSONデータとして送られます。セグメントは2つのアイテムからなるJSONオブジェクトでユーザーIDと一緒に送られます。2つのアイテムとはユーザIDとそれに付随する値です。付随する値は、セグメントIDとセグメント名から成るハッシュのいちランである別のオブジェクトに格納されます。以下に例を示します。

Example: "seg123":"DogOwner"

セグメント・フィードの準備は非常に手間がかかります。さらにセグメントを取り込むために利用可能な手段としてクライアントに提示するまえにエンジニアの承認が必要です。

With the User Profile Service, we now can load segments for each user via the User Profile batch upload process. In the User Segment file you associate user IDs with the segments they belong to. This can then be used to update the user information in the User Profile Service. The file format is given below, and for more information on the batch upload process please click here.

Feed File

Feed File	Details	Filename pattern
Segment Feed	A JSON-formatted data file of segment data for your site.	segments_sitename_YYYY_MM_DD.txt

File Specifications

The Omnichannel Personalization Cloud supports both full feed type of import and an incremental (delta type of feed) for the User Profile service. In addition to segments, the platform supports the import of user attributes, user linkings, and user preferences via the Batch Feed process or via User Profile Enrichment APIs.

Note: For more information on the additional information that can be imported with the User Profile service, refer to User Profile Batch Upload.

The feed file requires one JSON object per line. The object will contain two fields:

Name	Type	Required?	Definition
userId	ASCII	Yes	A unique identifier for the user.
Value	text	Yes	A valid JSON object that gives the unique segment identifiers and the human-friendly name of each segment for the individual user as a key : value pair. The segment value can be a string or a numeric value. Keys in this object may be required to conform to a maximum number of characters, depending on the total size of the segment data (which is strongly correlated to the number of records). So for example, if there are a large number of records to ingest, then your Algonomy team may ask for keys to be kept inside of three or four characters.

Sample

コピー

{"userId": "13579", "value":{"seg2134":"Dog Owner", "seg50plus":"High Spender", "Platinum": "Platinum Member"}}

Note: Each unique segment identifier is meant to have a unique context or value.

To upload the file, follow the basic FTP Instructions found here in the section titled "Upload the file."